UnitTestFailsDescriptionAndReason
Type
statement
Summary
Make a failing unit test assertion with a reason for brokenness
Syntax
broken test <Description> when <Condition> because <Reason>
Description
Make a unit test assertion, in the expectation that it will fail. The test is considered to have passed if Condition is true. The Description is a message that summarises the broken test, and the Reason explains why the test is broken (usually referencing a bug report).
If the test fails, it will not cause a test suite failure; instead, an "expected failure" will be recorded. If the test passes, an "unexpected pass" will be recorded instead of a normal test pass.
Parameters
| Name | Type | Description |
|---|---|---|
Condition | An expression that evaluates to | |
Reason | A short explanation of why the test is broken |
Examples
broken test "weird comparison" when 1 > 2 because "bug 12345"